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PortCom connects 
you to the world 


One ofthe most intriguing uses for the 
Portfolio is communications. 

With the Port, a serial interface, and a 
pocket modem (which are becoming 
cheaper by the month), you can log on 
from just about anywhere you can find a 
phone. This is especially useful forkeep- 
ing in touch with the office while you’re 
on the road. 

Unfortunately, the Portfolio does not 
havea built-in application that can control 
modem communications. And many of 
the public domain programs available do 
not make it easy to log on with the Port in 
acommunications world that expects your 
computer to have an 80 by 25 screen. 

PortCom, included on Re:Port Disk 
#6, has features that will make your Port- 
folio a worthy tool for conducting busi- 
ness telecommunications ontheroad (such 
asreading and writing email, sending fax 
messages, or optionally downloading pro- 
grams). 

PortCom includes a nice features list: 

¢ Script language that is very easy to 
use. 

¢ User-selectable screen modes. 

« ‘‘Hot-key’’ screen panning, which 
finally gives your Portfolio a decent win- 
dow on an 80 by 25 screen. 

e Optional linking to external proto- 


PortCom can be found 
on Re:Port Disk #6 in 
the \PORTCOM 


ON DISK subdirectory. 


cols for file transfer. 

¢ Menu-driven dialing directory. 

TousePortCom, youmustcopy all 
of the files in the \PORTCOM 
subdirectory of Re: Port Disk #6 to a 
RAM card or C: drive in the same 
directory. If you want todo Xmodem 
file transfers, you should put the pro- 
gram XTERM2.COM in the root (\) 
directory of your A: drive. 

Torun PortCom, typePCOM. The 
program is set up to go 2400 baud. It 
will initialize your modem. If you 
should wish to change settings, go to 
the Setup menu AFTER you begin 
PCOM, or use the Alt-B command 
(described below). Just hit Atari-S. 
All of the built-in programs will run 
from within PCOM. 

PortCom uses Alt- keys to do its 
stuff. The following commands are 
available: 

Alt-I : Send modem initialization 
strings (or any strings) contained in 
the file INIT. TXT. 

Continued on Page 6 
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From the Editor 


Re: Port moves to Iowa to begin second year 


This issue marks the end of the 
first year of Re:Port, and it also 
brings with it some changes. 

Re:Porthasmoved! Please send 
all correspondence and orders to the 
new address (anything that you have 
sent to the Oklahoma address will 
be forwarded, but sending to this 
new address is faster). 

Make a note of this change, 
please: 

Re: Port newsletter 

806-34 Benton Drive 

Iowa City, IA 52246-5207 

Our new phone number should 
serve you better. The number now 
has an answering machine, and if 
we’re not able to answer your call 
directly, you can leave a message, 
and we’ ll call you back. Be sure to 
leave your name, phone number, 
and a concise explanation of your 
problem. 

The best times to talk directly to 
someone at the new number are 
between | p.m. and 7 p.m. Central 
Time. The new number is (319) 
354-6893. 

Ofcourse, we chose tomove just 
one week beforethe deadline for the 


newsletter printing, but we’ve 
worked hard to make sure that you 
do not have any interruption in ser- 
vice. Please let us know if this has 
caused any inconvenience. 

Speaking of an interruption in 
service, for many subscribers, this 
may be your last copy of Re:Port 
newsletter unless you resubscribe 
now. 

If you have not received your 
““Re:Subscribe to Re:Port’’ flier, 
please use the form below to 
resubscribe and get a $5 Re:Port 
gift certificate. 

Even ifthis isn’t your last news- 
letter, you may want to get your 
resubscription in now to besure that 
you don’t miss an issue. 

Remember theplusses ofbeing a 
subscriber: Free, fast phone sup- 
port, low prices on Atari products, 
useful Portfolio programs, and of 
course the great hints, tips, news 
andreviews of Re: Portnewsletter! 

We’d like to thank everyone for 
making the first year of Re:Port a 
successful one. As was said in an 
earlier ‘‘From the Editor’’ column, 
people once asked, ‘“‘How are you 


going to fill a whole year of this 
newsletter?’’ Well, thesecond year 
is coming, and plenty more pro- 
grams are left to write for the Port- 
folio. 

Of course, we love to hear from 
our users for more ideas. But as 
long as Portfolio users like you are 
around, Re:Port newsletter will be 
here to serve you! 

Please enjoy this issue, which is 
filled with some great programs. 
Perhaps the most interesting and 
promising is PSOUND, which plays 
digital sound on the Portfolio. It 
may not be highly practical at this 
point, but as more sound files are 
available, we will distribute them. 
Also, PSOUND is a great program 
to show offthe Portfolio to others! 

Also, let us know what you think 
about the new ‘‘Best Sellers’’ col- 
umn. With enough interest, we will 
runthis every issue. This chart lets 
you know what other Portfolio us- 
ers are buying and using with their 
machines. It may help you decide 
what peripheral to buy next. 

Thank you all again. Look for 
Volume 2, Issue 1, in September! 


money order. 


_____ Yes! Please continue my subscription to Re:Port for $50 US. I understand that I will 
continue to receive Re:Port uninterrupted, with its disks of software, free user support, and 
unbelievable prices on Portfolio products available to subscribers only. I also will receive a $5 gift 
certificate, which I may use toward any purchase through Re:Port, including my next subscription, 
Portfolio products, back issues, or the new Re:Classifieds. I include $50 in US funds, check or 


Please print your name as it appears on your Re:Port mailing labels: 
Thank you! Please return this form with payment of $50 to: 
Re: Port newsletter, 806-34 Benton Drive, lowa City, [A 52246-5207 
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Industry News 


Port demo; RAM cards up to 2 megs 


An incredibly high-quality demonstration of the 
Portfolio may soon behitting your local stores. 

Don Thomas ofthe Atari Corporation has created a 
Portfolio presentation that runs on IBM-PC compat- 
ible computers with VGA color and optional digitized 
sound. 

The demonstration is set up torun indefinitely to be 
used as a showroom display. 

With this software, the Portfolio should be able to 
get more of a spotlight in some stores than its usual 
position behind the display case. 

Also, the demonstration shows exactly what the 
Portfolio can do ifthe sales person doesn't know what 
to tell a customer. 

The demonstration, called PDEMO, requires VGA 
graphicsto run. Italso uses a Sound Blaster cardifone 
is present. 

Ifyou would likea copy,send $2 to cover disk costs, 
postage and handling to Re:Port. 

PORT THE MOVIE STAR 

The Portfolio is becoming a big star! First it ap- 
peared in the smash ‘“Terminator 2,’’ and now it is 
working in a movie called *‘Made in America,”’ star- 
ring Whoopi Goldberg and Ted Dansen. 

Atari says that thedirector plans to usethe Portfolio 
in a doctor’s office scene. 

Atari will create custom screen displays for the 
scene. 

“*Made in America’’ is about a woman who learns 
that she was a test-tube baby. 

The movie is being filmed now in Berekely, Calif. 
Of course, Re: Port will let you know when the movie 
is out and whether the Portfolio made it to the silver 
screen or ended up on the cutting room floor. 

GOOD RAM CARD NEWS 

Good news about RAM cards andmore this month 
from Becker and Partner (B&P) in Germany. The 
company is supplying RAM cards up to 2 megabytes. 
They also have a unique rechargeable battery system 
forthe Portfolio. 

B&P offers two choices for RAM card sizes: both 
thetypical credit-card sizedmemory card, anda larger 


‘‘memory module’’ that hangs outside the computer. 

The advantage of the memory module is that it can 
be upgraded inexpensively. 

You pay only the price difference between the 
memory module you have and the one that you want. 

RAM cards and memory modules come in sizes 
from 128K to 2048K. 

Prices are in deutschmarks and include the German 
value-added tax. See your local paper for current 
exchange rates (approximations based on 1.48 DM to 
$1). 

128K card: 198 DM (approx. $134) 

256K card: 298 DM (approx. $202) 

512K card: 498 DM (approx. $337) 

1 meg card: 898 DM (approx. $607) 

2 meg card: 1698 DM (approx. $1,147) 

Memory modules arealso shipped with aROM card 
with PBASIC 4.1 on it. 

128K mm: 238 DM (approx. $161) 

256K mm: 338 DM (approx. $228) 

$12K mm: 538 DM (approx. $364) 

1 meg mm: 898 DM (approx. $607) 

2 meg mm: 1698 DM (approx. $1,147) 

Youcan contact B&P at: Becker and Partner GmbH, 
Postfach 190, Wilhelmstraae 91, 5100 Aachen, Ger- 
many. 

The B&P phone number is 241-50 90 18, fax num- 
ber is 241-50 95 77, and modem number is 241-53 53 
60. B&P also offers internal memory upgrades to 
256K, 384K and 512K. 

BAD MEMORY CARD NEWS 

The Australian home-brew RAM cards that we 
mentioned in a previous issue suffered a serious blow 
this month. 

Don McKenzie, who put together the RAM cards, 
has hadso much trouble with Atari Australia and DIP 
in England that he has decided to no longer deal with 
Atari products at all. It is sad that Atari and DIP 
wouldn’t be moreresponsive to one oftheir customers 
who was standing behind the Portfolio and trying to 
create products to expand its usefulness (and lowering 
RAM card prices as well). 


Page 4 Re:Port 


PBASIC 


Interacting with DOS through PBASIC 
“= Gleason on PBASIC 


© Copyright BJ Gleason, 1992 

PBASIC has the ability to allow users to interface to 
the DOS command line inseveral different ways: Read- 
ing the command lines, setting the ERRORLEVEL 
variable, as well as stuffing the keyboard buffer. These 
features allow users to use PBASIC in batch files and to 
launch other programs from inside PBASIC. 
READING THE COMMAND LINE 

When we start PBASIC, we can enter a number of 
parameters on the command linethat can then beread by 
your program. PBASIC provides the fiction COM- 
MAND$. The COMMANDS function returnsthe entire 
command tail as a single string. 

PBASIC adds two additional functions to allow ac- 
cessto the contents ofthe command line individually. If 
you area C programmer, you will be familiar with these 
functions already. The function ARGC returns the 
number of parameters on the command line when 
PBASIC starts. If ARGC returns 0, that means there 
wereno parameters. The valuereturnedcan then beused 
with the function ARG$(x) to extract the arguments 
from the command tail one at a time. 

ARG$(x)retumsthecommand linearguments. ARG$(1) 
would bethe first parameter after the PBASIC command. 
Under DOS 3.0 and later, ARG$(0) would bethe name of 
thePBASIC program. This will not work onthe Portfolio, 
since it is only version 2.1. You can determine the DOS 
version using the DOS VER function. 

Here’sa programto printout commandlinearguments: 
“print the entire command tail 
PRINT COMMAND$ 
“print how many arguments 
PRINT “Arguments: “ARGC 
IF DOSVER > 3.0 THEN sa=! ELSE sa=0 
“print them out, one at a time 
IF ARGC >= | THEN FOR x= sa to ARGC PRINT x, 
ARG$(x) NEXT x ENDIF 
SETTING THE ERRORLEVEL VARIABLE 

When PBASIC exits back to DOS, it normally sets 
the ERRORLEVEL variable to reflect the result of the 
program. [fyouarerunning PBASIC asa batch file, you 
can access the ERRORLEVEL code generated upon 
exit. This table indicates the values generated: 

0 - Successful exit 


u PBASIC files can be found on Re:Port Disk 
ON DISK #6 in the \PBASIC subdirectory. 


| - Program aborted 
2 - STOP encountered 

This ERRORLEVEL value canbe modifiedby using 
EXITCODE. The statement EXITCODE n, will exit 
PBASIC, and set-ERRORLEVEL ton. ERRORLEVEL 
can be tested in a batch file. 
CLS 
PBASIC myfile 
IF ERRORLEVEL 5 GOTO :ERROR .... 
STUFFING THE KEYBOARD BUFFER 

Aside from setting the ERRORLEVEL, the PBASIC 
program. can also issue a DOS command when it exits. 
The statement EXITCMD s$ will exit PBASIC, and 
placethe contents ofs$ in thekeyboard buffer. This will 
then be executed by the COMMAND.COM program. 
Hereis the command to display a directory of all the data 
files when the program exits: .... EXTTCMD ‘‘dir *.dat’’ 
{this exits PBASIC} A>dir *.dat ..... 

To invokethe internals applications, for example, the 
worksheet, youcan usethe statement: EXITCMD ‘‘app/ 


°° 


Ws 


About the Author 


Mr. BJ Gleason is an instructor at The 
American University in the Computer Sci- 
ence and Information Systems Department. 
He has been programming for more than a 
decade and is the author of PBASIC 4.9. 
You can write to him at: 

BJ Gleason 

The American University 

CSIS (Thin Air Labs) 

4400 Massachusetts Avenue, N.W. 
Washington, DC 20016 

CompuServe : 75300,2517 

EMAIL : bjgleas@auvm.american.edu 
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Games and graphics 


Keep PortMan alive in a monstrous maze 


Ever since a sample version of 
PortMan was included in a long 
list of programs in Issue#3, we’ve 
had requests for an update. 

Well, here’s amore challenging 
version for you Portfolio gameplay- 
ers. 

This version of PortMan fea- 
tures twomonsters who chase your 
PortMan around the maze. This 
time, they can eat you. 

Fortunately, you can fight back, 
thanks to four strategically placed 
power pills. 

These give youthe ability to eat 
one monster for each power pill. 
The power lasts until you eat one 
ofthe monsters. 

To play the game, load 


PortMan can be 
found on Re:Port 
Disk #6 in the 


ON DISK \PORTMAN 


subdirectory. WinPGC is in the 
\WINPGC subdirectory. 


PORTMAN.EXE along with the 
file PORTMAN.DAT onto your 
Portfolio. 

It is easiest, perhaps, to play the 
game withthe Portfoliotumed side- 
ways, but this is not mandatory. 

With the screen turned sideways, 
the playfield resembles the classic 
PacMan screen, with tunnels on 
either side and the power pills near 
the four corners of the maze. 

Use the keys W S A Z to move 


the PortMan around the screen. 
W = LEFT 


Z= RIGHT 
SUP 
A= DOWN 


Press ESC to end the game. 

This version also keeps score 
and speeds up as you progress from 
level to level. 

Let us know if you would like 
more updates to PortMan, or if you 
have suggestions for any Portfolio 
game. 

Although Re: Port prefers to fo- 
cus on thebusiness and utility uses 
for the Portfolio, recreation is cer- 
tainly a legitimate (and popular) 
use for this. incredible little ma- 
chine! 


WinPGC turns art into Portfolio graphics 


In our last issue, we gave you 
PGCVIEW for displaying .PGC 
graphics and PDRAW for creating 
the graphics. But what if you want 
to create something more elabo- 
rate? 

If you are a Microsoft Windows 
3+ user and know how to use the 
included Paintbrush program (or just 
have a lot of .BMP files around), 
youcanuse WinPGC to create some 
great .PGC graphics files for the 
Portfolio. 

The best way to create a .PGC 
graphic is to start with the Paint- 
brush program. Under Options, 
Image attributes, select ‘‘pels’’ un- 
der the Units heading. Type in 240 
for the width and 64 for the height. 
Select Black and White under Col- 
ors. This will set up a drawing 


screen that is the same size as the 
Portfolio’s. 

Now, you may use whichever 
drawing tools that you wish. (The 
ability to use TrueType fonts in 
Windows 3.1 can createsomestun- 
ning effects for corporate logo use.) 

Save your creation as a mono- 
chrome .BMP bitmap file. 

Now, run WinPGC. Youhaveto 
install it as an icon in the Program 
Manager orrunthe WINPGC.EXE 
file from the File Manager. 

Choose File, Load Bitmap to 
bring your.BMP fileinto WinPGC. 
If the .BMP file is larger than 240 
by 64 pixels, it will shrink to fit the 
space. 

To convert your artwork into a 
.PGC file, simply go to File, Save 
PGC. 


If you wish to do some simple 
manipulation of your .BMP file, 
use the BMP menu. You may En- 
large or Reduce the bitmap to fit 
your needs. 

Pleasenote that once theimage is 
saved as a.PGC file, you no longer 
havethis option,so do any manipu- 
lating that you need before saving 
the file. Your original .BMP file 
will not be changed in any way. 

Choose File, Exit to quit the pro- 
gram. 

Using the BMP, Enlarge and 
BMP, Reduce functions, it is easy 
to create several frames of simple 
.PGC files, which you canthen ani- 
mate using Don Messerli’s 
FLIXRT, which can be found on 
CompuServe’s APORTFOLIO for- 
um. 
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Alt-B : Set the baud rate and parity information. 
PCOM defaults to 2400 baud. You must use this 
command before trying to use a 1200 or 300 baud 
modem. After using this command, a file called 
COMSET.TXT will be created, so that PCOM will 
always default to the correct baud rate on startup. 

Alt-D : Call up the dialing directory contained in 
DIAL.TXT ... the file DIAL.TXT contains thename of 
theplace you are calling, followed by its phone number 
on thenext line, and then by thename ofits script file on 
the line after that. Ifyou do not want to use ascript file, 
put “‘none’’ using exactly those letters (i.e. no caps or 
spaces) for a filename. 

Alt-=: Quit the program. 

Alt-T : Turn on screen tracking (80 by 25, follow 
cursor) mode. 

Alt-S : Turn on screen static (80 by 25, don’t follow 
cursor) mode. 

Alt-N : Turn on screen normal (40 by 8) mode. 

Alt-1 through Alt-6 : When in screen static or screen 
tracked modes, these keys will let you “‘pan’’ aroundthe 
screen. This is excellent especially for static mode. The 
screen is broken down like this: 

Top left : Alt-1 Top right : Alt-2 
Mid left : Alt-3 Mid right : Alt-4 
Bot left : Alt-5 Bot right : Alt-6 

Usually, it is best to set PortCom into Static Mode 
with Alt-S, then use Alt-5 to go to the bottom of the 
screen. Use the other keys to look around ... especially 
effective is to wait for a screen to fill up, then hit all the 
keys in order; that way, you can read the entire screen! 
(See figure 1). 

Alt-G : Automatic logoff. Use with caution -- this 
will cut you offline. 

Alt-H : Halfduplex / fullduplex toggle. 

Alt-L : Log file on or off. Use to keep a disk log of 
everything that goes on while online. DO NOT USE 
THE BUILT-INEDITOR WHILETHELOG IS OPEN! 
After you closethe log, you mayhit Atari-Eto call up the 
built-in editor, and it will automatically load your log 
file. The Port will beep when the log is turned off. 

Alt-X: Xmodem Send/Receive. YOU MUSTHAVE 
THE PROGRAM XTERM2.COM in your root direc- 
tory ofthe A: drive. Otherwise, don’t even try this. 

Atari key: Gives ashorthelp screen of themost often- 


Figure |: Port screen areas with hot keys. 


used commands. 

That’s it for the terminal emulator itself. To write a 
script file, follow theexamples set in theincluded .SCR 
files, substituting your own ID and password. 

Basically, ascript file consists of three characters to 
wait for followed by the line that PortCom should send 
when it ‘‘sees’’ those three characters. 

You may also use special commands, but take care 
not tostart yourscript filewith them. PortCom will not 
begin toexecute ascript until it ‘“sees’’ some characters. 
You might want to begin each script with ‘““ECT’’ so 
that PortCom will seethat you’reonline. Then you may 
issue some of the following commands. 

Special commands are: 

logon : The line after this command should be the 
name of the file to store the log in. 

logoff : Follow this command with a blank line or 
another “‘logoff.”’ 

endofscript : Put this at the end of every script. 
Followit with ablank lineor withanother ‘‘endofscript’’ 
command. 

tracked : Set screen to tracked mode ... follow with 
blank line. 

static : Set screen to static mode... follow with blank 
line. 

normal : Set screen to normal mode ... follow with 
blank line. 

halfduplex : Go into half duplex mode... follow with 
blank line. 

fullduplex : Go into full duplex mode ... follow with 
blank line. 
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Featured programs 
Use TODO.HOO to create schedules 


If you run a business, you may 
often need to create a memo detail- 
ing your schedule. 

Ifyou keep your appointments in 
the built-in Diary application, 
TODO.HOO gives you an easy way 
to move Diary data into the built-in 
Editor application to create great- 
looking memos in an instant. 

To use TODO.HOO, you must 
copy it to the root (\) directory of 
your A: RAM card. 

Because of a limitation in how 
-HOO files operate, TODO.HOO 
will not function from any other di- 
rectory or any other drive. 

Then, after entering your daily 
schedule in the Diary application, 
call up the built-in editor by hitting 
Atari-E. 

When you are ready to bring the 
data for the day into your editor file, 
hit the Fn-6 keys. 

You will be presented with a list 
of .HOO files on your A: drive. 


TODO.HOO is on 
Re:Port Disk #6 
under the \TODO 
subdirectory; 


ON DISK 
HELP.COM and BDAY.COM are 
under the SOUND subdirectory. 


Choose TODO.HOO. 

You will then be shown the sys- 
tem date. 

If this is the day for which you 
wish to insert events into the editor 
file, press enter. Otherwise, enter 
the day in the format MM/DD/YY 
(i.e. 07/09/92 for July 9, 1992). 

TODO.HOO will read your 
DIARY.DRY file and import all of 
that day’s events into the current 
built-in editor file. 

You may then edit, format, and 
print the file as you see fit. 

Also, you may run TODO.HOO 
again (by hitting Fn-6), and bring in 
data from other days. 

This could be useful if you have 


stored work times fora week and are 
creating aschedule foryour employ- 
ees. 
Another use of TODO.HOO is to 
create a simple TODO list that you 
can edit as you go along while keep- 
ing the data safe in your Diary. 

For instance, you may want to 
leave every Diary entry alone, even 
after they have been completed, so 
that you have a record of what was 
scheduled to do on which day. 

If you use TODO.HOO to bring 
each day’s events into an editor file, 
you can edit that file all you wish, 
even deleting events as you com- 
plete them, so you have an idea of 
what youhave accomplished for the 
day (and how much you have left to 
do). 

For easy access, we suggest that 
youname the editor files that contain 
todo lists with the date. For ex- 
ample, use 070992.TXT for July 9, 
1992’s todo list. 


“Hello, this is your Portfolio speaking” 


Listen! Your Portfolio is talking 
to you. 

DIP, the company that originally 
created the Portfolio in England, has 
figured out that you canactually play 
digital sound on the Portfolio. 

Digital sound is one ofthe hottest 
topics in the computer world today; 
multimedia machines costing thou- 
sands of dollars use digital sound to 
achieve stunning voice and music 
effects. And now the Portfolio is 
becoming a multimedia machine! 

The sound is a bit grainy how- 


ever, and not very loud due to the 
size ofthe Port speaker. Still, witha 
good ear, it is very easy to hear what 
the Port is trying to say. 

We’ve included two samples of 
sound for thePortfolio, oneof which 
says, ‘‘Help! Somebody get me out 
of here! I’m trapped in this com- 
puter! Help, somebody!’’ The other 
sings the song ‘‘Happy Birthday To 
You.’’ Both of these sound files are 
in the form of executable .COM 
files; just type the name of the file, 
and you will hear the sound. 


As this technique progresses, the 
sounds should become more clear. 
Expect to see the Portfolio used as a 
speech synthesizer within the year, 
which will be wonderful for people 
with speech problems, who will be 
able to communicate withthe world 
via the Port. 

Also, digital sound couldbe added 
to Portfolio games formore realistic 
effects, and sound could even en- 
hance the Portfolio’s use as a busi- 
ness tool by creating portable multi- 
media presentations for the road. 
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Best sellers 


Instant Speller, 128K card most popular 


Instant Spell 
128K Card 
PowerBASIC 
Hyperlist 

64K Card 

Chess 

PC Card Drive 
Parallel interface 
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AC Adapter 
Mac cable 
Finance 

DOS Utilities 
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Tech. reference 
HTX 

File manager 
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After oneyear of Atari software and hardwaresales at 
Re:Port, now is the time to take a look at the top sellers. 

Instant Speller and the 128K RAM card are the most 
popular products, with 12.3 percent of sales each. 

Next are PowerBASIC, with 11.7 percent; HyperList, 
with 10.6 percent; 64K RAM cards, with 9.5 percent; 
Chess, with 8.4 percent; andthe PC Card Drive, with 7.8 
percent. 

Interestingly, the top software sellers are the newest 
releases. 

Of the top software sellers, only PowerBASIC has 
been around for the entire year. 

Re:Port would also like to announce several other 
available products that are not included on our Savings 
Surge flier. 

New from Atari is the carrying case, designed speci fi- 
cally for thePortfolio. It is$34.16 for Re: Port subscrib- 
ers. 

The carrying case is in and out of stock quickly, so 
please call first to get an estimate on its availability. 

Re: Port can also supply IBM parallel transfer cables, 


serial transfer cables, and Mac serial transfer cables. 
Cable prices are $15 each. Please indicate which cable 
you need! 

Also available is the Atari AC adapter forthe Portfolio. 
This is indispensable if you are doing a lot of serial 
communications. The price is $10 for Re:Portsubscribers. 

For people who want to delve more deeply into pro- 
gramming forthe Portfolio, a Technical Reference Guide 
is available for $60 to Re: Port subscribers. 

It includes Portfolio emulationsoftware for IBM com- 
patibles, which will let you test many Port programs on 
your desktop machine. 

Re: Port has received many inquiries for larger orders. 
Please call (319) 354-6893 if you would like to make a 
large order to find out about special discounts and ship- 
ping options. 

To order any ofthese products, send a check ormoney 
order to Re: Port, 806-34 Benton Drive, lowa City, IA 
52246-5207. 

Shipping is free via parcel post; add $7 for faster UPS 
shipping. Allow at least two weeks for delivery. 
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Beginner’s Column 


Don’t forget these handy tips you may have missed 


Inthis issue’s Beginner’s Column, we’!] takea look 
at someof the interesting little functions ofthe Portfo- 
lio that comein handy, yet youmay havemissed while 
reading the documentation. 

ALITTLE LIGHT READING 

If the Portfolio’s screen is too light or too dark for 
your taste, you can adjust the display by pressing and 
holding the Atari key together with theup arrowkey (to 
make the screen darker), or the Atari key and the down 
arrow key (to make the screen lighter). You may find 
that a little adjustment goes a long way toward read- 
ability on the Port’s screen. 

WARM ANDCOLD RUNNING BOOTS 

Unfortunately, the Portfolio does lock up some- 
times. You may find that the system stops responding 
to your keypresses, or that it is beeping uncontrollably, 
or it is printing garbage on the screen. 

You probably won’t be able to save what you were 
working on when your Portfolio crashed, but you 
almost always will be able to save the data on your 
internal C: drive, ifyou’ll follow these steps to escap- 
ing from lock-up: 

First, always try pressing and holding the CTRL- 
ALT-DEL key combination (this is often called the 
“‘three-finger salute’’ inthe DOS world). Youmust hit 
all three keys at the same time, and hold them for a 
second. 

The Portfolio should reboot (this is called a ‘‘warm 
boot’’ because the computer is never turned off), and 
you can go back to work without losing anything on 
your internal hard drive. 

If that doesn’t work, trythis second tip. Usea small 
pin or nail to press the button located on the underside 
of the Portfolio, above the Atari sticker. 

Press the button with the pin and hold it fora second. 
Your Portfolio should come back to life without any 
data loss. 

Third, try a “‘cold boot.’’ This will cause data loss. 
Your C: drive will be erased. 

(It is best to always keep a back up ofthe data on your 
C: drive. Usethe Backup/Restore program in a previ- 
ous issue of Re: Port every week or even every day to 


be surethat you have all of your data safe. Try to avoid 
storing much data on C: drive; opt for a RAM card 
instead.) 

You have two options. Either press and hold the 
silver bar that is behind the first battery inthe Portfolio’s 
battery case (you have to remove the battery first), or 
removeall three batteries forseveral hours. Removing 
the batteries is a sure-fire way to reset the Portfolio if 
something terrible happens and it locks up for good. 
Note again that you will losethe data on your C: drive 
with either of those options. 

AVOIDING THE LOCK UP 

The most common cause of Portfolio lock up is 
loading a file that is blank or ends with a space and a 
carriage return into the built-in editor. When you do 
this, the Portfolio will alert you with a box that says 
“ESC will attempt recovery.’’ At this point, all you 
can do is hit the ESC key and pray. This may or may 
not work, and might result in loss of C: drive data. 

To avoidthis, always press the RETURN key twice 
at the end of your Editor files. And never load a .TXT 
file into the editor ifit is less than three bytes in length 
(usethe DIR command to find out how big the fileis). 

The other built-in applications are fairly stable, so 
the only other major cause of lock up on the Portfolio 
is third-party programs. Usually, pressing CTRL- 
ALT-DEL will let you escape from these calamities. 

STICKY KEYS 

Sometimes, you have to hit two keys to perform one 
function on the Port folio, such as the FN key and the 2 
key to get help (remember that Fn-2 pulls up a help 
menu in all the built-in applications). 

However, you don’t have to stretch your fingers 
across the keyboard, or use two hands, to use function 
keys. 

Thekeys are ‘‘sticky,’’ which means that youcan hit 
the FN key, then let go of it, and then hit the number 
key. Holding both keys down at the same time just is 
not necessary. 

Always remember, too, that you can substitute one 
keypress (the Atari key) for that most often-used func- 
tion key, Fn-1. 
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‘Advanced Programming | 


PortCom unit adds quick, easy serial communications 


In this issue, we introduced 
PortCom, the Portfolio terminal pro- 
gram. 

Because serial communications 
are perhaps themost difficult to pro- 
gram, we offer the following .TPU 
that makes the most esoteric points 
of interrupt-driven serial communi- 
cations a bit more easy to under- 
stand. 

Portions of the code in the PAS 
source file for this unit are based on 
assembly programs copyright by 
DIP. 

Most of the routines have been 
modified for speed and compatibil- 
ity with Pascal language and have 
been extended somewhat. 

However, the names of the rou- 
tines were kept similar for easy cross- 
checking with the files included with 
the ‘*Technical Reference Guide’’ 
disk. 

Using this procedures and finc- 
tions areas simpleas adding the line 
“USES PORTCOM” to your Turbo 
Pascal 5.0, 5.5, or 6.0 program. 

Let’s takean in-depth lookat each 
command in turn. 
Proceduretmio_init; 

You must call TMIO_INIT be- 
fore using any of the other com- 
mands in the PortCom unit. This 
command sets the modem up for 
2400 baud operation and installs the 
interrupt driver routines. 

Basically, TMIO_INIT sets up a 
serial interrupt driver pointed to the 
routines in the PortCom unit, and it 
turns off BREAK checking, so the 
user will not be able to stop the 
program by hitting CTRL-C, 

This allows you to be sure to call 


PORTCOM.PAS and other source code can be found on 


ON DISK 


Re:Port disk #6 in the (SOURCE directory 


the proper exit routines before exit- 
ing. 

Futhermore, TMIO_INIT sets up 
theserial port vectors so thatthey are 
not affected by the Port being turned 
off. 

Noneed to understand all of that, 
however, because it is all taken care 
of for you in the unit with this one 
call. 

Proceduretmio_exit; 

You must call TMIO_EXIT at 
the end of your program, after all 
serial communications are finished. 

This will return the interrupts to 
their previous status, so that the user 
may remove the serial interface. 
Proceduretmio_char(cha: 
char); 

TMIO_CHAR sends the speci- 
fied character (from #0 to #255) to 
the serial port. 

Use this after akeypress to senda 
single character or put it in a loop to 
send a whole string, like this: 

FOR” A> $= ae 
LENGTH(STRING) 
TMIO_CHAR(STRING[A]); 
Procedure printchar; 

PRINTCHAR needs to be called 
every so often to retrieve characters 
from theserial port and print them to 
the screen. 

Usually, you will want to call this 
while waiting for user input: 

WHILE NOT KEYPRESSED 
DO PRINTCHAR; 

Procedure logon(filename : 


TO 
DO 


string); 

LOGON turns on data logging, 
sending everything that is sent and 
received to the file specified by 
FILENAME. 

Procedure logoff; 

LOGOFF closes the data file cre- 
ated by LOGON and stops all data 
logging. 

Procedure dropdtr; 

Youmayusethe DROPDTR com- 
mand to instantly take the modem 
offline. 

Note that some modems do not 
respond to the DROPDTR com- 
mand,so be sureto check this before 
trying touseitas a way tologoff your 
modem. 

Function modemready : 
boolean; 

The MODEMREADY function 
returns TRUE ifthe modem is ready 
and FALSE if the modem is not 


ready. 
It may help you to take a look at 
the program source code 


““PCOM.PAS,” which uses this unit. 
It gives examples of how to tie into 
the PortCom unit in order to take 
advantageof, and build on, the power 
that it can provide. 

Programmers are encouraged to 
call Re: Port with questions or com- 
ments. If you can expand on the 
commands in the PortCom unit, 
please let us know. Addition of a 
high-quality protocol, such as 
Zmodem, is probably thenext step! 
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Online Services 


Contests and chats 


CompuServe’s APORTFOLIO forum remains the 
most active online area for Port users. Check out their 
huge message and download sections. Also, be on the 
lookup for an upload contest, to be announced soon. It 
willmost likely involveuses for the built-in applications. 

GEnie's Menu 950 for the Portfolio features weekly 
live chats with Re: Port editor David E. Stewart every 
Sunday night from 10 p.m. Eastern until everyone gets 
tired of talking. Stop by and get instant advice! 


Re:Classifieds 


Catalogues of the new files avail- 
able on CompuServe and GEnie 
are available on your Re:Port Disk 
ON DISK — #6 in the \ONLINE directory. 
CompuServe wants all Re:Port readers who aren’t 
members to sign up now, so they’ve put forward a 
special offer to our subscribers. 

You can get a sign-up kit and $15 worth of free 
connect time by calling (800) 848-8199 (ask for 
Operator 198). Tell them that you heard about this 
from Re:Port, an APORTFOLIO forum member. 


For sale: companion! , 
2 64K RAM cards never used -- 768K memory,40megharddrive, | .,, a. See oe 
$75 each 2400 baud internal modem, color 25 words or less : $3.50 
1 simulated leather black Portfo- monitor, 5.25 and 3.5 disk drives, * . pr eaes Stas 
lio Carrying Case--holds Portfolio, digital sound, and tons of software, chide phailstuncherirwilcass, of 
batteries, cards, paper, etc. -- $25 including games and word proces- add $1 to have RePort newsletter act asa 
Call (408) 249-8576. sor. ag sonal ap aes 
For sale: $300 firm (plus shipping). Re-Port newsletter 
Tandy 1000TL IBM-compatible Contact Re:Port at (319) 354- 806-34 Benton Drive 
computer. PerfectPortfolio desktop 6893. ee ee 


Contest 
Get $5 off any Re:Port product with Contest #6 


Congratilanonsttosrare samron. the winnersof fat ao. = ae ca al ee a 7 
Re:Port Contest #5. His prize, a Portfolio graphics | Re:Port Contest #6 | 
animation of his name, appears on Re:Port Disk #6 | Name: : 
piece Die iain Yi cngeh _. .... | Favorite use of the Portfolio: l 

This time, let’s give away a $5 Re:Port gift certifi- 
cate. This is good toward any purchase through Re: Port, a es SEO = PS a | 
suchas productorders, resubscriptions, or Re: Classifieds. Favorite application (pick two): 7 

To enter, make a copy of the form at the right, fill it Editor Worksheet Address Book 
in, and send it to Re: Port, 806-34 Benton Drive, Iowa | Diary Calculator | 
City, IA 52246-5207. Deadlineis August 15. A oxides Se cae, ees wee cash es as ae 4 
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Mailbox 


Dear Re:Port, 

Thank you very much for the In- 
stant Spellercard. As acontest win- 
ner I will do my utmost to live up to 
your expectations. Here is some 
feedback on various subjects. 

I think each issue gets a little 
better than the last. I like Mailbox 
very much, also User-to-User, and 
most important, the For Beginners 
page. I know it is hard for youto get 
so elementary, but the effort is wel- 
come. 

I would like you to continue the 
issue #5 topic ‘‘Howto get files’’ on 
page 8, and talk about using the card 
drive. Also Industry News is very 
important; availability ofRAM cards 
in still a vital issue. 

One ofthe few questions Ihave is 
this: I wish I could identify the 
memories inthe calculator appmore 
quickly than pulling downthemenus. 

I see that I can type text on the 
main screen of calculator display, 
but when you do anything it van- 
ishes. 

In other words, it would beniceto 
come up on M1 and see a text state- 
ment like ‘“Check Balance’’ on the 
screen. 

For the other memories it would 
benice to identify them also. Is there 
any place I can “‘label’’ these memo- 
ries so I know what is in them? 

Here is my last subject: I tried to 
get a Terminator 2 card but it is not 
possible. 

I called Atari and they can’t help 
me. They referred me to my dealer, 
a guy in Fort Collins, Colo.; he can’t 
get it either. 

I think the interest and support 
from Atari is rotten; and yet the Port 
is such a nice machine. 


If you have any Terminator 2 
cards, I'l buy one. 

-- Dan Schwartz 
Colorado 

[Editor’s note: Unfortunately, 
you cannot attach a text label to the 
calculator’s memories. Youmay be 
interested in getting a Finance card, 
whichcan manipulatethe calculator’s 
memories within itself. Of course, 
youarethen limited to the labels that 
Financeuses in its calculations. 

Also, for calculations that use 
memories frequently, youmay want 
to set up a Worksheet, using cells 
instead ofmemories. That way, you 
can label them easily and they are 
updated automatically as data 
changes. 

As for the Terminator 2 card, 
Re:Port only has one copy left, and 
it isn’t for sale! We will contact 
Atari and see if we can get them to 
print somemorecopies, and ofcourse 
we'll let you know. } 


Dear Re:Port, 

I carry my Portfolio wherever I 
go. It is small enough to fit in my 
purse or briefcase, and I can carry so 
much knowledge in it. I use my 
Portfolio mostly as a Rolodex. I 
never have to worry about buying a 
new address book, erasing phone 
numbers, etc. 

Iusethecalculator alot, soIdon’t 
haveto carry an extracalculator with 
me. I just got some games, and I 
have been playing them on planes 
and in airports, since Itravel a lot. I 
use the editor to take notes when I 
need tojot thingsdown for later, and 
also to carry around tech tips at my 
job, so I don’t have to carry around 
stacks of paper. 


I don’t use the diary anymore, 
because it gets too full and slows 
down -- isthere any way tospeed this 
up without having to make a diary 
for each month, or deleting the old 
items? 

I am in the process of signing up 
with Prodigy, GEnie, and 
CompuServe to try and find other 
users to share ideas with. I am 
interested in finding more games 
and other software, i.e. sales man- 
agement, traveler’s guide, etc. 

I am also interested in finding a 
program or software package that 
will allow meto do automatic back- 
ups to my Macintosh. Right now I 
can do them but I have to move one 
file at a time, which gets tedious. 

Ireally enjoy the newsletter. 

-- Trudy Ornest 
California 


[Editor’s note: Theslowness you 
experience with the Diary applica- 
tion is probably just that it takes so 
long to load the file. You hit on the 
answer already, unfortunately -- you 
can either make a different diary for 
each month, or delete the old items. 

Actually, a nice compromise 
might be to start a new diary each 
month. At the end of every month, 
you could merge that diary data to 
one large “‘archive’’ diary, using the 
built-in Editor tomergethe two text 
files. 

That way, you would have two 
diary .DRY files on your Portfolio; 
one for the current month, and one 
that includes all past data for refer- 
ence purposes. Of course, the file 
with the old data would be slow, but 
how often would you be accessing it 
compared with the current data file?] 


SAMINGS SURGE 


Re:Port newsletter also sells Atari’s Portfolio products at large discounts. You don’t have to 
subscribe to order and save money, but subscribers get 10 percent off our already low prices! 
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Port Package (see description) $525.75 $385.00 


Portfolio: The hand-held computer comes with Atari’s File Manager/Tutorial Card. 

Serial and Parallel Interfaces: Connect to modems, hard drives, desktop computers, printers and more. 

RAM Cards: Re:Port’s prices on these credit-card sized disks can’t be beat! 

PC Card Drive: Simply the best way to transfer information between a desktop PC and the Portfolio. Allows the PC 
to read, write, and format credit-card memory disks. 

DOS Utilities Card: (ROM card) Contains many handy DOS-based utilities written for the Portfolio. 

Finance Card: (ROM card) Allows you to keep track of difficult financial calculations. 

PowerBASIC: (ROM card) This version of BASIC for the Portfolio gives you the power to create fast, standalone 
applications that you can use on any Portfolio. 

Hyperlist: (ROM card) Organize your thoughts and data with this incredible outliner program. 

Chess: (ROM card) Pit your chess strategy against the Portfolio’s. 

Instant Spell: (ROM card) Atari’s latest! Not the same as the spell checker available in Re:Port newsletter. Includes 
a 100,000 word dictionary. Use it within the editor or from DOS. 

Carrying Case: Keep your Portfolio, RAM cards, and accessories together in this handy case while you travel. 

Port Package: Includes the Portfolio, a64K RAM card, a parallel interface, a parallel cable, an AC adapter, and 
a year of Re:Port. An incredible value! Package prices include fast UPS 2nd-Day Air shipping. 


To order, send check or money order (U.S. funds only) to: 

Re:Port newsletter 

806-34 Benton Drive 

lowa City, [A 52246-5207 

Please allow 4 to 6 weeks for free Parcel Post delivery. Add $7 per item for faster UPS shipping. 
Iowa residents please add appropriate sales tax. Information only: (319) 354-6893. No phone orders. 


